home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / os2 / cenvi2.arj / CENVI2.TXT < prev    next >
Text File  |  1994-01-16  |  12KB  |  220 lines
  1.                      CENVI FOR OS/2, DOS, AND WINDOWS
  2.                                Version 1.008
  3. (Now executes faster and can create stand-alone, royalty-free executables.)
  4.  
  5. Cmm (C minus minus) is 'C' for the rest of us.  CEnvi runs Cmm programs in
  6. the DOS, Windows, and OS/2 environments (more to follow).  Together, CEnvi
  7. and Cmm make the power and flexibility of the C programming language part
  8. of every computer user's environment without the hardware, time, and
  9. programmer resources needed for developing full-blown C programs.
  10.  
  11. With CEnvi and Cmm, anyone can take control of their computer environment.
  12. C is not just for programming nerds anymore.  CEnvi utilities, macros,
  13. batch files, and scripts can quickly be created, shared, and modified among
  14. all computer users, professional and amateur alike.
  15.  
  16. CEnvi can be incorporated at a pace that is comfortable to you: you may
  17. only want to use CEnvi code set up by a more experienced user, you may want
  18. to enhance existing batch files with a line or two of CEnvi code, or you
  19. may write complete utilities using CEnvi.  The following statement is a
  20. single-line CEnvi example that you can include into batch files to return
  21. ERRORLEVEL 1 only on Fridays:
  22.  
  23.     CEnvi "date = ctime(time())  return( strstr(date,"Fri") ? 1 : 0 )"
  24.  
  25. Nombas provides over a hundred samples such as this one--many single-line
  26. and other complete program files--and more samples are added every day to
  27. provide solutions to CEnvi user's needs.  Sample programs included with the
  28. CEnvi shareware demonstrate Cmm programming; looping in batch files;
  29. altering environment variables; using environment variables in mathematical
  30. equations; user input; reading time; sounds; setting ERRORLEVEL; file
  31. read/write; OS/2 WPS and PM calls; controlling OS/2, PM, and Windows tasks;
  32. interacting with DOS, OS/2, and Windows operating systems; defining windows
  33. and Windows functions; extending PATH; scheduled command execution; setting
  34. NUMLOCK; and much more. Even if you don't learn the Cmm programming
  35. language, you could still personalize these samples to suit your needs. (Do
  36. you need a program to tell if it is a Thursday? I'll bet that you could
  37. "reprogram" the above sample Cmm code to return ERRORLEVEL 1 only on
  38. Thursdays!)
  39.  
  40. If you choose to learn the Cmm programming language (C programmers will
  41. find that they already know it), then step through the Cmm programming
  42. tutorial in the CEnvi Registered User's Manual. This tutorial takes you
  43. step by step through the planning, creation, and debugging of a simple text
  44. editor: CmmEdit.
  45.  
  46. With the new /BIND option, you can turn your Cmm code into an executable.
  47. This executable can be freely distrbuted without paying any royalties to
  48. Nombas.
  49.  
  50.  
  51. CEnvi costs $38 for a license that includes the OS/2, DOS, and Windows
  52. versions.  Additional site licenses (which do not include the 100+ page
  53. manual) are $15 each. The CEnvi Unregistered Shareware package is a working
  54. version of CEnvi with occasional registration reminder screens.
  55.  
  56. The most recent versions of CEnvi Unregistered Shareware, including sample
  57. files, are always available via anonymous FTP from "world.std.com" in the
  58. "pub" directory: cenvi2.zip, cenvid.zip, and cenviw.zip are CEnvi for OS/2,
  59. DOS, and Windows, respectively.  From CompServe: CEnvi for OS/2 is
  60. CENVI2.ZIP in OS2USER library 4, CEnvi for DOS is CENVID.ZIP in IBMSYS
  61. library 1, and CEnvi for Windows is CENVIW.ZIP in WINSHARE and WINUSER
  62. library 6.  Also available for download from the Nombas BBS (suggested dial
  63. string ATDT16173916565,,,,,44444).
  64.  
  65. Nombas may be reached at:
  66.    Nombas                        Internet: bsn@world.std.com
  67.    P.O. Box 875                  CompuServe: 72212,1622
  68.    Medford, MA  02155  USA       Phone: (617)391-6595
  69.                                  BBS: (617)391-6595 ext. 44 after 2nd ring
  70.                                       (e.g., ATDT16173916595,,,,,44444)
  71. ************************* CENVI2.ZIP FILE LIST *************************
  72.  
  73. CENVI2.ZIP, the Unregistered Shareware CEnvi package for OS/2, contains the
  74. following files:
  75.  
  76. *CENVI.EXE: CEnvi shareware executable for DOS, OS/2, or Windows.
  77. *CENVI2PM.EXE: Gateway program, executed trasnparently by CEnvi, for access
  78.   to PM-dependent system calls
  79. *CENVI.DOC: CEnvi Shareware Manual, Chapter 1: CEnvi Unregistered Shareware
  80. *CMMTUTOR.DOC: CEnvi Shareware Manual, Chapter 2: Cmm Language Tutorial
  81. *CMM_VS_C.DOC: CEnvi Shareware Manual, Chapter 3: Cmm versus C, for C
  82.   Programmers
  83. *CENVILIB.DOC: CEnvi Shareware Manual, Chapter 4: Function Library
  84. *LICENSE.DOC: CEnvi Unregistered Shareware License Agreement
  85. *README.DOC: Introductory file. Read this first for quick intallation.
  86. *REGISTER.DOC: CEnvi registration form
  87. *INSTALL.CMM: Cmm source file for installing this shareware version
  88. *AllDirs.cmd: Perform a command in this directory and all sub-directories
  89. *AllFiles.cmd: Perform a command on all files matching a given file
  90.   specification
  91. *Ascii.cmd: Display the ascii character table
  92. *BatLoops.cmd: Examples of various methods CEnvi can use to allow looping
  93.   within batch files
  94. *BckGrnd.cmd: Specify a new file as your desktop background image
  95. *BigFont.cmd: Chooses the largest font for a Windowed OS/2 session.  Uses
  96.   KeyPush.lib.
  97. *Border.cmm: Draw a simple border on the screen
  98. *Bouncy.cmd: Start a bouncy OS/2 Command Window. This demonstrates moving
  99.   windows, embedding multiple Cmm executables within one file, passing
  100.   keystrokes, clipboard use, and silliness.
  101. *BoxFont.cmd: Show and alter default font for DOS and OS/2 command-line
  102.   windows
  103. *BoxPos.cmd: Show and alter default position for DOS and OS/2 command-line
  104.   windows
  105. *BugHunt.cmd: Example for using the ClipBrd.lib routines. Constantly scan
  106.   clipboard for "bug" in clipboard text
  107. *CBPrint.cmd: Send contents of the clipboard to the printer
  108. *CEnviSet.cmd: This file can be used instead of CEnvi.exe if you are using
  109.   environment variables as Cmm variables and need them to be changed in the
  110.   current OS/2 environment.
  111. *ClipBrd.lib: Library of routines for reading from or writing to the
  112.   Windows clipboard
  113. *CmmEdit.cmm: VERY simple text editor; developed step-by-step in the
  114.   tutorial chapter of the Registered CEnvi Manual.
  115. *Comm.lib: Serial communications routines
  116. *DelTree.cmd: Delete a directory tree
  117. *Devices.cmd: Show status of system devices.
  118. *DevIOCtl.lib: Function library for OS/2's DosDevIOCTL functions
  119. *DirStat.cmd: Extract specific fields from an OS/2 "DIR" listing
  120. *DiskFree.cmd: Display free space on a disk drive
  121. *DoFiles.cmd: Perform any command on a list of files selected from a file
  122.   dialog box
  123. *DosCalls.lib: Example library of "wrapper" function calls to OS/2 API
  124.   calls in the DosCalls library.  This file is "#include"ed in many of the
  125.   other example files.
  126. *DosObj.cmd: Demonstrate how to initialize any session type, program,
  127.   settings, and window positions.  In this case a DOS Window, but this is
  128.   easily changed.
  129. *DumpIni.cmd: Display profile settings from a .INI file; uses Profile.lib
  130. *EditCmd.cmd: Use PM's file dialog (via FileDlg.lib) to select a *.cmd file
  131.   to edit.
  132. *EPM.cmd: Wrapper for EPM.EXE for C programmers which will bring in related
  133.   *.c, *.H and *.asm files
  134. *ErrLev.cmd: Execute a command and set the ERRLEV value as the return code,
  135.   which makes ERRORLEVEL a variable
  136. *Fibonacc.cmm: Two methods for generating the Fibonacci sequence
  137. *FileDlg.lib: A simple interface to the WinFileDlg() PM function.  This
  138.   library file is #include'd in some of the other CEnvi sample files.
  139. *FileFind.cmd: Wildcard search for files on current drive or on all drives
  140. *FileIO.lib: Function to interface directly with OS/2's File IO
  141. *Find#.cmm: Extract a number from wordy output; used by DirStat.bat
  142. *FranTick.cmm: Animated tick who drank too much coffee
  143. *GetUKey.cmd: Display a choice prompt and then set an environment variable
  144.   based on user's selection 
  145. *Hello.cmm: My first Cmm program. Used to begin the Cmm tutorial.
  146. *HexDump.cmd: Display hexadecimal dump of a file
  147. *IDLE.cmd: Change process priority to run a CEnvi program only during
  148.   system idle time.
  149. *IdleProg.cmd: Execute a program in the background; i.e., run only during
  150.   system idle time.
  151. *Install.cmm: Install this registered version of CEnvi.
  152. *IsDay_1.cmd: One method to check if it is a specific day of the week
  153. *IsDay_2.cmd: Another method to check if it's a specific day of the week
  154. *IsItFri.cmd: Is it Friday?
  155. *KbdRate.cmd: Alter the typematic rate of the keyboard
  156. *KeyCode.cmd: Display keycode of any key pressed
  157. *KeyGhost.cmd: Sample for using KeyPush.lib to determine if CEnvi is worth
  158.   the price of registration.
  159. *KeyPush.cmd: Send keystroke commands directly to a window by window title;
  160.   a quick interface into KeyPush.lib
  161. *KeyPush.lib: Library of routines for sending keystrokes to PM or Windowed
  162.   applications.
  163. *KeyState.cmd: Get or set the state of the NumLock, CapsLock, or Insert
  164.   keys for current session or for the whole WPS
  165. *Kill.cmd: Terminate a running process by Process ID, Window title, full
  166.   name, or partial name
  167. *MsgBox.lib: A wrapper library for the PM WinMessageBox() function.  This
  168.   file is #include'd in other CEnvi sample files.
  169. *MsgBoxes.cmd: Show various message box types using the function in
  170.   MsgBox.lib.
  171. *MultiDir.cmd: OS/2's "DIR" command allowing multiple file specifications
  172. *NekoSavr.cmd: This basic screen saver program runs NEKO.EXE, OS/2's cat &
  173.   mouse game, when the mouse keys and keyboard have been idle.
  174. *NumLock.cmd: Turn on NUMLOCK key once, or maintain NUMLOCK ON. A shadow of
  175.   NumLock.cmd can be put in startup folder to default computer to NumLock
  176.   ON. "NumLock 1000" will check every second to make sure that NUMLOCK is
  177.   still set.
  178. *OneADay.cmd: Perform any command(s) no more than once per day
  179. *OS2Time.cmd: Show time according to computer's internal clock
  180. *Parents.cmd: Show hierarchical list of ancestor's process ID's and names
  181. *PathAdd.cmd: Add a directory to your PATH environment variable.
  182. *PathDel.cmd: Remove a directory from your PATH environment variable
  183. *PathStak.cmd: Multi-level save or restore of current drive and directory
  184.   so that you can change drives and directories and still return to this
  185.   one
  186. *PMdll.lib: Example library of "wrapper" routines to function in the PM DLL
  187.   (Presentatiom Manager Dynamic Link Library).  This file is "#include"ed
  188.   in many of the other example files.
  189. *Primes.cmd: Demonstrate automatic array allocation for calculating prime
  190.   numbers
  191. *PrmptDay.cmd: Change command-line-prompt to display today's date
  192. *ProcList.cmd: Show list of all running processes; their names and ID's
  193. *Profile.lib: Function library for accessing Profiles; i.e. .INI files
  194. *Quote.cmd: Choose a text-mode "profound" quote at random
  195. *QuotePM.cmd: Choose a PM-mode "profound" quote at random
  196. *RndBckgr.cmd: Randomly select desktop background, at specified interval,
  197.   from a list of graphic file specifications
  198. *RunTime.cmd: Rudimentary scheme for executing a command at a certain time
  199.   of day.
  200. *Setup.cmd: Open the OS/2 Setup folder on the desktop
  201. *ShutDown.cmd: Automated shutdown of OS/2 system
  202. *SortLen.cmd: Sort any file based on line length
  203. *Sound.cmd: Play a frequency for a given time period
  204. *Switch.cmd: Switch foreground application to another process base on
  205.   process ID, full name, or partial name
  206. *Terminal.cmd: A VERY basic terminal program; demonstrates COMM.LIB
  207. *Threads.cmd: Display list of all threads in all running processes
  208. *ValidDir.cmd: Verify if a directory is valid
  209. *Wait.cmd: Pause and do not return for specified number of seconds
  210. *Windows.cmd: Start up full-screen windows session with specified Windows
  211.   program.  This file contains specific DOS notebook settings that should
  212.   be altered to meet your computer's configuration.
  213. *WinList.cmd: Display list of all PM windows
  214. *WinSet.cmd: Set the position, size, state, etc... of a PM Window
  215. *WinTools.cmd: Demonstrate many of the capabilities of WinTools.lib
  216. *WinTools.lib: Library of routines for manipulating PM windows by name or
  217.   by handle
  218. *WPFolder.cmd: Open a desktop folder for any specified directory and
  219.   optionally switch to that window
  220.